Skip to main content
Version: 8.0

GraalPy Installation

note

GraalPy requires Resolve Actions Pro version 8.0.0.1. For more information, please see Release Notes 8.0.0.1

Introduction​

GraalPy is a high-performance implementation of the Python 3 language built on the GraalVM platform. It is ideal for polyglot applications, embedded Python in Java, and environments where CPython compatibility isn’t strictly required. GraalPy supports many standard Python packages and allows integration into modern JVM-based applications with strong performance and security guarantees.

This guide explains how to:​

  • Install GraalPy 24.2.1 on Linux (x86_64 / amd64)
  • Set up an isolated Python environment
  • Install pip
  • Use pip to install Python packages like numpy and pandas

Prerequisite: Check for GCC Compiler (Version ≥ 8.4 Required)​

Some Python packages rely on native extensions, which need a C compiler like GCC to build and install.

To verify if GCC is installed:

gcc --version

If it is not installed, you can install it using:

Ubuntu/Debian:

sudo apt update && sudo apt install build-essential

To install a specific version (e.g., 9 or later), use the following commands:

sudo apt install gcc-9 g++-9
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 100
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 100

RHEL/CentOS/Fedora:

sudo dnf groupinstall "Development Tools"
sudo yum install centos-release-scl
sudo yum install devtoolset-9
scl enable devtoolset-9 bash

Download and Extract GraalPy 24.2.1 (Linux amd64)​

Download the GraalPy community build for Linux (64-bit):

wget https://github.com/oracle/graalpython/releases/download/graal-24.2.1/graalpy-community-24.2.1-linux-amd64.tar.gz

Extract the archive:

tar -xzf graalpy-community-24.2.1-linux-amd64.tar.gz
cd graalpy-community-24.2.1-linux-amd64

Create a Virtual Environment​

Run the GraalPy command to create a new Python virtual environment:

./bin/graalpy -m venv venv

This creates an isolated environment in the venv/ directory.

Activate the Environment​

Activate the virtual environment by running:

source venv/bin/activate

Once activated, the shell will use the GraalPy interpreter from the virtual environment by default.

Update the graalpy.virtualenv.install.home property to reference this virtual environment path:

graalpy.virtualenv.install.home=</path/to/graalpy/home>/venv

Install pip (Python Package Installer)​

By default, GraalPy does not include pip. You must bootstrap it manually:

venv/bin/graalpy -m ensurepip

Verify that pip is available:

venv/bin/pip --version

The output should confirm that pip is installed.

Install Python Packages (Example: numpy, pandas)​

Install packages using the GraalPy interpreter:

venv/bin/graalpy -m pip install numpy pandas

This installs numpy and pandas into your GraalPy virtual environment.